package org.jeecg.modules.wms.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.apache.ibatis.annotations.Param;
import org.jeecg.modules.wms.entity.WmsInventory;
import org.jeecg.modules.wms.vo.WmsInventoryVO;

import java.util.List;
import java.util.Map;

/**
 * 库存Mapper接口
 */
public interface WmsInventoryMapper extends BaseMapper<WmsInventory> {
    
    /**
     * 查询库存分页列表
     * 
     * @param page 分页参数
     * @param query 查询条件
     * @return 分页数据
     */
    IPage<WmsInventoryVO> queryInventoryPageList(Page<WmsInventoryVO> page, @Param("query") Map<String, Object> query);
    
    /**
     * 查询库存列表
     * 
     * @param query 查询条件
     * @return 库存列表
     */
    List<WmsInventoryVO> queryInventoryList(@Param("query") Map<String, Object> query);
    
    /**
     * 根据物料编码和仓库ID查询库存
     * 
     * @param materialCode 物料编码
     * @param warehouseId 仓库ID
     * @param locationId 库位ID
     * @return 库存信息
     */
    WmsInventory findByMaterialAndWarehouse(@Param("materialCode") String materialCode, @Param("warehouseId") String warehouseId, @Param("locationId") String locationId);
    
    /**
     * 移动端库存查询
     * 
     * @param page 分页参数
     * @param params 查询参数，包含searchKeyword、materialTypes、stockStatuses等
     * @return 分页数据
     */
    IPage<WmsInventoryVO> queryInventoryForMobile(Page<WmsInventoryVO> page, @Param("params") Map<String, Object> params);
}